Obtener producto

curl --request GET \
  --url https://api.example.com/menus/products/{id}

{
  "data": {
    "id": "hamburguesa-clasica",
    "uid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Hamburguesa clásica",
    "description": "Carne Angus con lechuga y tomate.",
    "image_url": "https://cdn.example.com/hamburguesa-clasica.jpg",
    "channels": {
      "APP": {
        "id": "app",
        "uid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "name": "App móvil",
        "stores": {
          "centro": {
            "id": "centro",
            "uid": "c3d4e5f6-a7b8-9012-cdef-123456789012",
            "name": "Centro",
            "fulfillment": {
              "DELIVERY": {
                "uid": "d4e5f6a7-b8c9-0123-def4-567890abcdef",
                "id": "delivery",
                "type": "DELIVERY",
                "name": "Delivery",
                "pricing": {
                  "minimum_quantity": 1,
                  "maximum_quantity": 10
                },
                "availability": {
                  "status": "AVAILABLE",
                  "schedules": [{
                    "monday": { "start_time": "11:00:00", "end_time": "22:00:00" }
                  }],
                  "out_of_stock_until": null
                }
              }
            }
          }
        }
      }
    },
    "cms_template_id": null,
    "cms": null,
    "status": "ACTIVE"
  }
}

GET

menus

products

{id}

Obtener producto

curl --request GET \
  --url https://api.example.com/menus/products/{id}

{
  "data": {
    "id": "hamburguesa-clasica",
    "uid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Hamburguesa clásica",
    "description": "Carne Angus con lechuga y tomate.",
    "image_url": "https://cdn.example.com/hamburguesa-clasica.jpg",
    "channels": {
      "APP": {
        "id": "app",
        "uid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "name": "App móvil",
        "stores": {
          "centro": {
            "id": "centro",
            "uid": "c3d4e5f6-a7b8-9012-cdef-123456789012",
            "name": "Centro",
            "fulfillment": {
              "DELIVERY": {
                "uid": "d4e5f6a7-b8c9-0123-def4-567890abcdef",
                "id": "delivery",
                "type": "DELIVERY",
                "name": "Delivery",
                "pricing": {
                  "minimum_quantity": 1,
                  "maximum_quantity": 10
                },
                "availability": {
                  "status": "AVAILABLE",
                  "schedules": [{
                    "monday": { "start_time": "11:00:00", "end_time": "22:00:00" }
                  }],
                  "out_of_stock_until": null
                }
              }
            }
          }
        }
      }
    },
    "cms_template_id": null,
    "cms": null,
    "status": "ACTIVE"
  }
}

Devuelve un producto del menú activo, incluyendo nombre y descripción localizados, imagen, y precios y disponibilidad por canal. Usa este endpoint para páginas de detalle o para hidratar ítems del carrito.

Requiere un access token de Fire spark obtenido mediante intercambio de token.

Parámetros de ruta

Parámetro	Descripción
`id`	Identificador externo del producto. Solo alfanuméricos, `_` y `-`. 1–64 caracteres.

Parámetros de consulta

Parámetro	Requerido	Descripción
`store_id`	Sí	Identificador externo de la tienda.
`channel_id`	Sí	Identificador externo del canal.
`fulfillment_id`	Sí	Identificador externo de fulfillment.

Request

curl "https://firespark.vercel.app/api/storefront/v1/menus/products/hamburguesa-clasica?store_id=centro&channel_id=app&fulfillment_id=delivery" \
  -H "Authorization: Bearer ACCESS_TOKEN"

Response

{
  "data": {
    "id": "hamburguesa-clasica",
    "uid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Hamburguesa clásica",
    "description": "Carne Angus con lechuga y tomate.",
    "image_url": "https://cdn.example.com/hamburguesa-clasica.jpg",
    "channels": {
      "APP": {
        "id": "app",
        "uid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "name": "App móvil",
        "stores": {
          "centro": {
            "id": "centro",
            "uid": "c3d4e5f6-a7b8-9012-cdef-123456789012",
            "name": "Centro",
            "fulfillment": {
              "DELIVERY": {
                "uid": "d4e5f6a7-b8c9-0123-def4-567890abcdef",
                "id": "delivery",
                "type": "DELIVERY",
                "name": "Delivery",
                "pricing": {
                  "minimum_quantity": 1,
                  "maximum_quantity": 10
                },
                "availability": {
                  "status": "AVAILABLE",
                  "schedules": [{
                    "monday": { "start_time": "11:00:00", "end_time": "22:00:00" }
                  }],
                  "out_of_stock_until": null
                }
              }
            }
          }
        }
      }
    },
    "cms_template_id": null,
    "cms": null,
    "status": "ACTIVE"
  }
}

Objeto producto

Campo	Tipo	Descripción
`id`	string	Identificador externo del producto.
`uid`	string (UUID)	Identificador interno de Fire spark.
`name`	string	Nombre visible. 1–100 caracteres.
`description`	string	Descripción opcional. Hasta 500 caracteres. `null` si se omite.
`image_url`	string	URL de imagen del producto.
`channels`	object	Precios y disponibilidad por canal, tienda y fulfillment.
`cms_template_id`	string (UUID)	Plantilla CMS vinculada. `null` si no hay plantilla asignada.
`cms`	object	Solo lectura. Plantilla CMS resuelta cuando está asignada.
`status`	string	`ACTIVE` o `INACTIVE`.

Cada entrada de fulfillment en channels requiere uid, id, type, name, pricing y availability. El objeto availability incluye status, schedules (null cuando no hay restricción de horarios) y out_of_stock_until opcional.

Respuestas de error

Estado	Descripción
`401`	Access token ausente o inválido.
`403`	El token no tiene acceso a este producto.
`404`	Producto no encontrado en el menú activo para este contexto.

Obtener categoría Obtener

⌘I

​Parámetros de ruta

​Parámetros de consulta

​Request

​Response

​Objeto producto

​Respuestas de error

Parámetros de ruta

Parámetros de consulta

Request

Response

Objeto producto

Respuestas de error